/*
 * Copyright (C) 2008 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.example.android.apis.appwidget;

import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ComponentName;
import android.content.Context;
import android.content.pm.PackageManager;
import android.os.SystemClock;
import android.util.Log;
import android.widget.RemoteViews;

// Need the following import to get access to the app resources, since this
// class is in a sub-package.
import com.example.android.apis.R;

/**
 * A widget provider. We have a string that we pull from a preference in order
 * to show the configuration settings and the current time when the widget was
 * updated. We also register a BroadcastReceiver for time-changed and
 * timezone-changed broadcasts, and update then too.
 * 
 * <p>
 * See also the following files:
 * <ul>
 * <li>ExampleAppWidgetConfigure.java</li>
 * <li>ExampleBroadcastReceiver.java</li>
 * <li>res/layout/appwidget_configure.xml</li>
 * <li>res/layout/appwidget_provider.xml</li>
 * <li>res/xml/appwidget_provider.xml</li>
 * </ul>
 */
public class ExampleAppWidgetProvider extends AppWidgetProvider {
	// log tag
	private static final String TAG = "ExampleAppWidgetProvider";

	@Override
	public void onUpdate(Context context, AppWidgetManager appWidgetManager,
			int[] appWidgetIds) {
		Log.d(TAG, "onUpdate");
		// For each widget that needs an update, get the text that we should
		// display:
		// - Create a RemoteViews object for it
		// - Set the text in the RemoteViews object
		// - Tell the AppWidgetManager to show that views object for the widget.
		final int N = appWidgetIds.length;
		for (int i = 0; i < N; i++) {
			int appWidgetId = appWidgetIds[i];
			String titlePrefix = ExampleAppWidgetConfigure.loadTitlePref(
					context, appWidgetId);
			updateAppWidget(context, appWidgetManager, appWidgetId, titlePrefix);
		}
	}

	@Override
	public void onDeleted(Context context, int[] appWidgetIds) {
		Log.d(TAG, "onDeleted");
		// When the user deletes the widget, delete the preference associated
		// with it.
		final int N = appWidgetIds.length;
		for (int i = 0; i < N; i++) {
			ExampleAppWidgetConfigure.deleteTitlePref(context, appWidgetIds[i]);
		}
	}

	@Override
	public void onEnabled(Context context) {
		Log.d(TAG, "onEnabled");
		// When the first widget is created, register for the TIMEZONE_CHANGED
		// and TIME_CHANGED
		// broadcasts. We don't want to be listening for these if nobody has our
		// widget active.
		// This setting is sticky across reboots, but that doesn't matter,
		// because this will
		// be called after boot if there is a widget instance for this provider.
		PackageManager pm = context.getPackageManager();
		pm.setComponentEnabledSetting(new ComponentName(
				"com.example.android.apis",
				".appwidget.ExampleBroadcastReceiver"),
				PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
				PackageManager.DONT_KILL_APP);
	}

	@Override
	public void onDisabled(Context context) {
		// When the first widget is created, stop listening for the
		// TIMEZONE_CHANGED and
		// TIME_CHANGED broadcasts.
		Log.d(TAG, "onDisabled");
		PackageManager pm = context.getPackageManager();
		pm.setComponentEnabledSetting(new ComponentName(
				"com.example.android.apis",
				".appwidget.ExampleBroadcastReceiver"),
				PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
				PackageManager.DONT_KILL_APP);
	}

	static void updateAppWidget(Context context,
			AppWidgetManager appWidgetManager, int appWidgetId,
			String titlePrefix) {
		Log.d(TAG, "updateAppWidget appWidgetId=" + appWidgetId
				+ " titlePrefix=" + titlePrefix);
		// Getting the string this way allows the string to be localized. The
		// format
		// string is filled in using java.util.Formatter-style format strings.
		CharSequence text = context.getString(R.string.appwidget_text_format,
				ExampleAppWidgetConfigure.loadTitlePref(context, appWidgetId),
				"0x" + Long.toHexString(SystemClock.elapsedRealtime()));

		// Construct the RemoteViews object. It takes the package name (in our
		// case, it's our
		// package, but it needs this because on the other side it's the widget
		// host inflating
		// the layout from our package).
		RemoteViews views = new RemoteViews(context.getPackageName(),
				R.layout.appwidget_provider);
		views.setTextViewText(R.id.appwidget_text, text);

		// Tell the widget manager
		appWidgetManager.updateAppWidget(appWidgetId, views);
	}
}
